home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / utilitys / 88 / ugbase / ugbase.doc < prev   
Encoding:
Text File  |  1987-09-03  |  8.4 KB  |  160 lines
  1.  
  2.                               UGbase
  3.                          by:  Joe Andrews
  4.  
  5.   This is the updated version of UGBase.  Thanks to Dennis Hevener 
  6. for  his help in overcoming the 100 record limit and a  few  other 
  7. changes  that make the program run a little smoother.Some  of  the 
  8. changes made in this version are the inclusion of a search routine 
  9. that will allow you to search on any one or combination of fields, 
  10. Selective  print  options,  which allow you to  print  only  those 
  11. records  found during the most recent search,  and the  option  to 
  12. print multiple copies.  A few other bugs were fixed along the  way 
  13. also. Most of the following is a repeat of the last doc file, with 
  14. the inclusion of the use of the added features.
  15.  
  16.   To use UGbase,  simply load it in and go.  The    file    called 
  17. 'DBASE.RSC',  which  had  to be in the same  directory  as  UGBase 
  18. before,  can now be located in a few other locations.  When UGBase 
  19. trys to load the resource file,  it will first look in the current 
  20. directory.  If  it  doesn't find it there,  it will  look  current 
  21. directory of the default drive,  and finally in the root directory 
  22. of the default drive.  The program runs only  in  medium  or  high 
  23. resolution.  When  the menu appears,  you can select a variety  of 
  24. options.  Most functions will be familiar to most of you,  but I'll 
  25. cover them anyway.
  26.  
  27.   The 'File' menu is where most of the editing options are  found. 
  28. At  the top of the list is 'New'.  This will let you start with  a 
  29. clean slate.  'New' first confirms that you really want to start a 
  30. new  data  base  because it clears out any  records  currently  in 
  31. memory. Selecting 'OK' will clear out memory and open up the input 
  32. dialog box.
  33.  'Open' will load in a previously saved file.  A file selector box 
  34. will  open  up allowing you to select a file to  load.  One  minor 
  35. improvement  here  is that now the selector box opens  up  in  the 
  36. current  directory,  not the root directory as before.  This  will 
  37. save  a little time if your data fiels are in a folder  with  your 
  38. program. UGBase checks to see whether the file is in UGBase format 
  39. and  will let you know if it isn't.  One change here is  that  the 
  40. old version of UGBase is NOT file compatible with the new version, 
  41. although you CAN load in old files into the new version.  This was 
  42. done  because there was a bug in the old program that dropped  the 
  43. last  7  bytes from each record before saving it.  Since  the  vew 
  44. version fixes this,  all the record pointers were screwed up. So I 
  45. put  in a routine that checks to see which version the  data  file 
  46. was saved with and loads it in accordingly. It only saves the file 
  47. in  the new format,  therefore the old version is  not  compatible 
  48. with  the new.  But,  at least you don't have to type in all  that 
  49. stuff again!
  50.  
  51. 'Save' will save the file in memory to disk under the current  file 
  52. name.  If you previously loaded a file,  UGBase will save it under 
  53. that name.  If you use this option on a new file, the file will be 
  54. saved  with  a blank file name,  so be sure to use 'Save  as'  for 
  55. first-time saves.
  56.  
  57.    'Erase' is exactly the same as 'New' except you  aren't  thrown 
  58. into  the  input  dialog box.  It erases the file  in  memory  and 
  59. returns to the menu.
  60.  
  61.    Use 'Edit' to open up the input dialog box and view  or  modify 
  62. records.
  63.  
  64.   Of course,  'Quit' will exit you back to the desktop or shell or 
  65. whatever  you  ran UGBase from.  Quitting will lose  any  data  in 
  66. memory so be sure to save anything you don't want to lose.  UGBase 
  67. makes sure you want to quit and lets you go back and save anything 
  68. if you need to.
  69.  
  70.    In the 'Options' menu,  you'll find 'Sort',  which simply sorts 
  71. the  data base by last name only.  In future versions,  you'll  be 
  72. able to sort by any one or a number of fields.  But for now,  last 
  73. names will have to do.
  74.  
  75.   The 'Search' function has been added to this version of  UGBase. 
  76. I  think it is a very flexible and easy to use  function,  not  to 
  77. mention FAST. If you select Search, another dialog box will appear 
  78. with  a number of fields shown.  All you have to do is enter  data 
  79. into  each  field you want searched.  After you enter in  all  the 
  80. data,  select  Search at the bottom of the box.  UGBase will  then 
  81. find  all  matching records and open up the input box so  you  may 
  82. view  or  edit  them.  Some  buttons  in  the  box  work  a  little 
  83. differently  in  search  mode.  First,  the ADD  button  has  been 
  84. disabled.  The viewing keys now act only on searched records,  ie, 
  85. pressing  NEXT will show you the next matching record,  PREV  will 
  86. show the previous, etc. Delete and Update work the same.
  87.  
  88.    'Print' now works fully.  I'll bet you were wondering what  the 
  89. other  boxes  were for!  You have the option  of  selecting  three 
  90. styles  of  printout:   Label  style in  normal  print,  Label  in 
  91. condensed  print,  and Column in condensed print.  The reason  you 
  92. cannot print normal column is because all that info won't fit on a 
  93. single line of paper.  Selecting 'All' will print out all  records 
  94. in the file.  'Selective' will print out only those records  found 
  95. during the last Search operation.  You can now enter in the number 
  96. of copies you want printed, too.
  97.  
  98.    When you first run UGbase,  you'll need to select  'New'.  This 
  99. will open up the input dialog box where you will enter in all  the 
  100. data.  Simply  type  in  the appropriate  data  into  each  field, 
  101. pressing  either 'Tab' or the up and down arrows to  move  between 
  102. fields.   When adding new names to the file,  select 'Add' in  the 
  103. Edit box at the bottom of the dialog.  This will add the record to 
  104. the end of the file and step you to the next free record. Continue 
  105. this way until all records are entered.  After you enter the  last 
  106. record,  instead of pressing 'Add', press 'Update'. This will save 
  107. the record in memory as in Add,  but will not open up a new entry. 
  108. Update  is also used for editing or updating an individual  record 
  109. in the file.  You can delete any entry by pressing 'Delete'.  This 
  110. will  erase  the  record from memory and move  all  the  remaining 
  111. records up to fill the gap.  You can also view any record by using 
  112. the Viewing buttons on the bottom left of the dialog.  'Next'  and 
  113. 'Prev' will move you forward and backward through the file,  while 
  114. 'Start'  and 'End' will move you to the first and last records  in 
  115. the file, respectively.
  116.  
  117.     When you have finished entering all records,  press 'Exit'  to 
  118. return to the menu.  If you are working on a new file, you'll need 
  119. to use 'Save as' and enter a file name to save the file  under.  If 
  120. you've  already saved the file,  UGbase will use the file name  you 
  121. saved or loaded it under.
  122.  
  123.   Well,  those are the new changes. Sorry it took so long to get a 
  124. new version out, but with work and 'programmer's burnout' I really 
  125. didn't  feel  much  like working on the  thing.  Now  I  know  why 
  126. programmers take so long to get new versions of programs to us! It 
  127. seems that the more bugs you fix,  the more you find! As I said  in 
  128. the  opening lines,  Many thanks to Dennis Hevener (DHEVENER)  for 
  129. helping fix some of the problems.  He is the one who fixed the 100 
  130. record limit. Limit is now 200 records, but can be extended to the 
  131. available memory.
  132.    That's about it.  This is my first project in C and on the  ST, 
  133. so the source code probably leaves a lot to be desired.  There are 
  134. probably a few bugs still lurking around, too, so if you find any, 
  135. leave me mail for J.K.ANDREWS.  I realize you could do this easily 
  136. with DB Master One,  but I had to do something productive and this 
  137. was something our club needed. The  source  code  is 
  138. included so any of you with Megamax can modify and customize it to 
  139. suit your taste.  Also,  if your printer is not Epson  compatible, 
  140. you can go in and modify the printer codes to fit your situation.
  141.  
  142.  
  143.                                             Joe Andrews
  144.  
  145. P.S.  Our user's group,  STar, is interested in corresponding with 
  146. other user's groups. We publish a newsletter about once a month or 
  147. when  we  get  enough  articles.  Anyone  interested  in  swapping 
  148. newsletters can contact me here on GEnie,  or you can write us  at 
  149. the addresses below.
  150.  
  151.  
  152.    Joe Andrews                             Tom Hayslett  (Pres)
  153.    115 Katherine St.                       2003 Bob White Ct.
  154.    Ft. Walton Beach, Fl, 32548             Mary Esther, Fl, 32569
  155.  
  156.  
  157.  
  158.   
  159.  
  160.